topLevel

Type

command

Summary

Opens a stack in an editable window.

Syntax

topLevel <stack>

Description

Use the topLevel command to display a stack in an editable window.

An editable window can be resized (if its resizable property is true), and its controls can be selected, moved, and changed. To edit a stack of a different style (a palette, modeless, or modal dialog), use the topLevel command to display it in an editable window.

The topLevel command closes the stack and reopens it as an editable window, so closeStack and openStack, closeCard and openCard, and (if applicable) closeBackground and openBackground messages are sent to the current card as a result of executing this command. Use the lock messages command before executing topLevel if you want to prevent these messages from being sent.

If the stack is already in an editable window, the topLevel command does not close and reopen it.

Parameters

Name	Type	Description
stack		Any stack reference.

Examples

toplevel stack "project1"

toplevel this stack

topLevel the mousestack

Related

property: cantModify, selected

command: palette, lock messages, modeless, choose

glossary: property, current card, execute, message, editable window, command, control, modal dialog box

message: openCard, closeStack, closeCard, closeBackground, openStack, openBackground

object: stack

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server